home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / telecomm / bbs / maxsdoors2.lha / gw118d.lzh / readme < prev    next >
Text File  |  1991-12-21  |  12KB  |  356 lines
  1.  
  2.        _________    ___         _______    _______       _______      ___
  3.       /  ______/\  /  /\       / ___  /\  /  __  /\     /  ___  \    /  /\
  4.      /  /\_____\/ /  / /      / /\_/ / / /  /\/ / /    /  /\_/  /\  /  / /
  5.     /  / /___    /  / /      / / // / / /  /_/ /_/    /  /_//  / / /  / /
  6.    /  / //_ /\  /  / /      / / // / / /  ____   /\  /  ___   / / /  / /
  7.   /  /_/_/ / / /  /_/___   / /_// / / /  /\__/  / / /  /\_/  / / /  /_/___
  8.  /________/ / /________/\ /______/ / /_________/ / /__/ //__/ / /________/\
  9.  \________\/  \________\/ \______\/  \_________\/  \__\/ \__\/  \________\/
  10.  
  11.                   ___      ___    _______      _______
  12.                  /  /\    /  /\  /  ___  \    /  ___  \
  13.                 /  / /   /  / / /  /\_/  /\  /  /\_/  /\
  14.                /  /_/_  /  / / /  /_//  / / /  /_//  / /
  15.               /  |/   \/  / / /  ___   / / /  ___   / /
  16.              /           / / /  /\_/  / / /  /\_|  |\/
  17.             /__/\___/\__/ / /__/ //__/ / /__/ / |__| |
  18.             \__\/\__\/\_\/  \__\/ \__\/  \__\/  \___\|
  19.  
  20.  
  21.  
  22.   A strategic multi-user warfare online game for the Paragon & Xenolink BBS
  23.  
  24.  
  25.                            By Janne Paakkonen
  26.  
  27.               Version 1.18d, released November 25th, 1991
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.          Daniel Frost, Tommy Green, Marc Vaillancourt, Jonathan Forbes
  35.          Lars Siden, Riku Bergkvist, Per Careberg, Oskar Sodergren and
  36.          Hugo Fortin
  37.  
  38.                         - thank you for your help!!!
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.    CONTENTS OF THIS DOCUMENT:
  52.    ~~~~~~~~~~~~~~~~~~~~~~~~~~
  53.  
  54.                      Chapter
  55.  
  56.    Announcement ....................................... 1
  57.    About Global War ................................... 2
  58.         This archive ....................................... 3
  59.         Installing ......................................... 4
  60.         How the program works .............................. 5
  61.         Sysop's menu ....................................... 6
  62.         Message files ...................................... 7
  63.         News option ........................................ 8
  64.         Score file ......................................... 9
  65.    Ansi graphics ...................................... 10
  66.    Earlier versions ................................... 11
  67.         Contact ............................................ 12
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.   1. ANNOUNCEMENT
  94.   ~~~~~~~~~~~~~~~
  95.   This is a FREEWARE product, meaning that YOU are allowed to copy all the
  96.   files in this archive as much as you like. And use the game, for free.
  97.  
  98.   Please, spread this program! I'm sure there are others who would like to
  99.   get this game. But please, don't  CHANGE  anything  in the files, except
  100.   the GW.con file (more about that below). Thank you.
  101.  
  102.   Read the CHANGES textfile included to see what has been changed in this
  103.   version.
  104.  
  105.  
  106.   2. ABOUT GLOBAL WAR
  107.   ~~~~~~~~~~~~~~~~~~~
  108.   Global War is  an online game  for the Paragon and Xenolink BBS'es  that
  109.   will run on most Amigas.  It has  been tested  with the  A500/2000/3000,
  110.   using OS 1.2, 1.3 and 2.x.
  111.  
  112.  
  113.   Global war was originally written for the IBM PC machines by Joel Bergen.
  114.   Looking around I discovered that there was no similar game for the Amiga,
  115.   quite sad in fact, so I decided to make this one for us who like online
  116.   games and especially the Paragon and Xenolink BB-systems.
  117.  
  118.   NOTE: 
  119.   The 1.18d version is made  to work with TWO  bulletin board systems; the
  120.   Paragon and Xenolink BBS'es. This text refers mostly to Paragon, but you
  121.   can change the name to Xenolink almost wherever you want. 
  122.  
  123.  
  124.   I wrote this game during a period of July-90 to November-91. I have not
  125.   been in touch with the author of PC's Global War, which means I haven't
  126.   seen the original source code. But the game is the nearly same, and even
  127.   larger than  PC's Global War.
  128.  
  129.   I added the  possibility  to play  mission games and  to choose  between
  130.   different types of commendation sets.  Currently the  only thing that is
  131.   not implemented is the GWterm, a  special  terminal program  that commu-
  132.   nicates with Global War and lets the user  make his moves with the mouse.
  133.   The GWterm also draws  all graphics on a custom screen,  making the game
  134.   much faster and convenient to play.
  135.   If there are any people out there who are interested in making such a
  136.   program, I'll be glad to help you anyway I can. I would make the GWterm
  137.   myself if I had the time...
  138.  
  139.  
  140.  
  141.  
  142.   3. THIS ARCHIVE
  143.   ~~~~~~~~~~~~~~~
  144.   You should now have the following eight files:
  145.  
  146.   README          - What you are reading right now
  147.   CHANGES         - What has been changed since v1.0
  148.   INSTALL         - Read this if you already have v1.0 installed.
  149.   Globalwar       - The executable
  150.   GW.con          - The GW config file
  151.   GW.doc          - Complete document about the online game Global War
  152.   GWpoints.doc    - How the points are given
  153.   GWteam.doc      - How team play works
  154.   GWranks.txt     - File with ranking names, read the CHANGES document of
  155.                     how to edit this file, please.
  156.  
  157.  
  158.   Please, don't spread this archive if it doesn't have all these files!
  159.  
  160.  
  161.  
  162.  
  163.   4. INSTALLING
  164.   ~~~~~~~~~~~~~
  165.   Make a directory in your DOORS-directory called Globalwar  and
  166.   copy all files from this archive into the directory.
  167.  
  168.   The most important file besides the executable is the GW.con config file.
  169.   Sysops can modify the data lines as much as they want, to make Global War
  170.   fit their system. Read the GW.con file to learn about the data lines and
  171.   how to configure the game.
  172.  
  173.   The Ranking list file  and the All Times Highest list  file do not exist
  174.   at the beginning, they will  be created later by the program.  The files
  175.   will be saved with the filenames you have written in GW.con. A good idea
  176.   is to save the Ranking list file as PARAGON:Bulletines/Bul?.txt, so that
  177.   you may view the file from the bulletins menu.
  178.  
  179.   You may change the default pathnames in GW.con as much as you like, just
  180.   make sure the pathnames are correct. When you're done with the file, save
  181.   it in the DOORS:Globalwar/ directory.
  182.  
  183.   If you have done something wrong, the program will tell you about it when
  184.   you run it. It will NOT crash your system if there is an error in GW.con.
  185.  
  186.   After that, edit the DOORS.DAT file (you Paragon sysops know what I mean)
  187.   to make Global War run as a door.
  188.  
  189.   You are now ready to play Global War in your bbs (and Cli).
  190.  
  191.  
  192.  
  193.  
  194.   5. HOW THE PROGRAM WORKS
  195.   ~~~~~~~~~~~~~~~~~~~~~~~~
  196.   Global War uses about 120 KB when running as a door (160 if executed from
  197.   Cli), including the program itself.  
  198.  
  199.   If you are a sysop you should be pleased - I have worked really hard to
  200.   make sure that the program won't get locked because of a user logoff.
  201.  
  202.   As soon as the carrier is lost, the program will save all its files and
  203.   give back the memory it has allocated.      If you play the game in CLI,
  204.   you can try out how the program behaves if the carrier really  is lost.
  205.   You simulate the effect  with the escape key.  Just press the key,  and
  206.   the program will save everything and quit.  The same  thing  happens if 
  207.   you click on the close box with the mouse.
  208.  
  209.   If there ever (never, I hope) is a more serious failure somewhere, like
  210.   the system has run out of memory, then the program will first inform the
  211.   user about what's happening, if the user is still online, thereafter it
  212.   will create an error log file called err.txt in the directory it was run
  213.   from. So to see why the program behaved like it did that night  at 3 am,
  214.   read the err.txt file, if it has been created.
  215.  
  216.   If there is very little memory left in the system, like about 50 KB, the
  217.   program  will run in the  "low-capacity mode"  which means that the maps
  218.   are not being drawn, only the armies and menus will be displayed.
  219.  
  220.  
  221.  
  222.  
  223.   6. SYSOP'S MENU
  224.   ~~~~~~~~~~~~~~~
  225.   There is a special sysop's menu,  that only sysops can access,  in other
  226.   words: a user with minimum access level of 15.
  227.   The sysop's menu gives  you a lot of power;  players and whole games can
  228.   be deleted among other things.
  229.   If you run Global War from the Cli, you  will always have  access to the 
  230.   sysop's menu.
  231.  
  232.  
  233.  
  234.  
  235.   7. MESSAGE FILES
  236.   ~~~~~~~~~~~~~~~~
  237.   The program has a built-in message read/write option. The only thing I'm
  238.   saying about this is that the files are stored with the names GWmess.X.Y,
  239.   where X is the number of the game,  and Y the number of the player (both
  240.   starting from zero).  Now you don't have  to wonder  why they are  named
  241.   like that...
  242.  
  243.  
  244.  
  245.  
  246.   8. NEWS OPTION
  247.   ~~~~~~~~~~~~~~
  248.   The News routines record everything  a player does  in a game and  store
  249.   the data in a file called GWnews.X, where the X is the game number.  The
  250.   news-text that the player will see online is a temporary file created in
  251.   RAM: and is  deleted after the  player has read it,  so you can not have
  252.   these files in your bulletines - sorry.  The reason for this is,  that a
  253.   game  might have  either visible or  hidden player names,  and it is not
  254.   possible to support both alternatives with only one file.
  255.  
  256.   The GWnews.X file grows  as the game continues,  but it will hardly grow
  257.   over 8 KB (the data is somewhat crunched).  The file size depends on the
  258.   amount  of players in the game,  how many moves they make and how often.
  259.  
  260.  
  261.  
  262.  
  263.   9. SCORE FILES
  264.   ~~~~~~~~~~~~~~
  265.   About the score files:     Read the GW.doc manual for information of the
  266.   GWalltime.txt  and GWscore.txt  file  to see how they work.   You decide
  267.   where these files will be saved in the GW.con config file.
  268.  
  269.  
  270.  
  271.  
  272.   10. ANSI GRAPHICS
  273.   ~~~~~~~~~~~~~~~~~
  274.   It is heavily recommended that the users have a terminalprogram that
  275.   has IBM ANSI built-in (including the IBM-characters), as Global War
  276.   uses ANSI quite heavily.
  277.  
  278.   When running in CLi, the program opens a custom screen with 8 colors.
  279.   It uses a diskfont called "pc.font", size 8. Make sure you have this
  280.   font in your FONTS: directory. If the program can't find the font, it
  281.   will use whatever font was available (most likely the topaz.font).
  282.  
  283.   For you tech-people out there:
  284.   How does the program output ANSI-files to the modem through Paragon
  285.   and Xenolink)?
  286.  
  287.   The solution I made was to create a temporary ANSI-file in RAM: and then
  288.   give the BBS the order to type the file to the modem and screen.  If you
  289.   peek into RAM: when  Global War is drawing  an ANSI-picture,   you  will
  290.   find a file called GW_TEMP-IDx.gr1, that is the temporary file. X is the
  291.   program's Task adress (the task adress is used to distinguish the file
  292.   from other copies of Global War running at the same time). 
  293.   The file is always deleted after the drawing has finished.
  294.  
  295.  
  296.  
  297.  
  298.   11. EARLIER VERSIONS
  299.   ~~~~~~~~~~~~~~~~~~~~
  300.   This is not the first release of the program, there are some old versions
  301.   on the market, released some time ago.
  302.  
  303.   If you have one of the old  versions running in your bbs and do not want
  304.   to reset  the game, don't worry.  This version is fully  compatible with
  305.   older ones. Just replace the files in this archive with the ones in your
  306.   Global War directory and off you go.
  307.  
  308.   I said fully compatible.  Well, this is not the whole truth.  In the 1.0
  309.   version I re-wrote the mission routines and added some new missions.
  310.   This means that if your old Global War version number was less than 1.0,
  311.   the players'  missions  will be  changed to new ones,  if there  are any
  312.   mission games running in your GW. 
  313.  
  314.   Everything else will run without difficulties.
  315.  
  316.   Every reported bug has been removed in this version and the program has
  317.   been tested a lot,  but if you  despite that should find a bug,  please
  318.   report it to the author at the adress or bbs below, so it can be fixed.
  319.  
  320.  
  321.   11. FUTURE
  322.   ~~~~~~~~~~
  323.   It's up to you, folks! I think this game is completed now. Every possible
  324.   feature is there, and the bugs are history.
  325.  
  326.   But if you come up with something interesting for this game, I'm all ears...
  327.  
  328.   People have asked me to make Global War compatible with the DLG BBS,
  329.   so I'll probably release a DLG-Global pretty soon...
  330.  
  331.  
  332.   12. CONTACT
  333.   ~~~~~~~~~~~
  334.   Unfortunately Arkham Asylum, the old Global War support bbs, left
  335.   left the scene some time ago. For now, you can write to me in the
  336.   XENOLINK UTIL echo, which should be available in most Xenolink systems.
  337.  
  338.   If you want to write a REAL letter (not electronical!) to the author,
  339.   the adress is:
  340.  
  341.  
  342.       Janne Paakkonen
  343.       Tetorpsv 104
  344.       194 36  UPPLANDS VASBY
  345.       S-SWEDEN
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.          END OF THIS DOCUMENT, NOW LET'S GET ON WITH SOME GLOBAL WAR!!!
  354.  
  355.  
  356.